Decrement Variable Icon Action

Decrement Variable Action

Declaration

<AMDECREMENTVARIABLE RESULTVARIABLE="text [variable name]" AMOUNT="number">

See Also

Increment Variable, Create Variable, Set Variable

Description

Decrements a variable by the specified amount.  The variable must contain a valid number.  If the variable is blank, zero is assumed.

Practical Usage

Used to decrease the value of a "counter" variable. Normally counters are used inside of a loop.

Parameters

General Tab

Variable to decrement
Text [variable name], Required
MARKUP: RESULTVARIABLE="thecurrentdate"

Specifies the name of the variable to decrement.

Amount
Number, Optional - Default is 1
MARKUP: AMOUNT="5"

Specifies the value that the variable should be decreased by.

Notes

Using Variables
All variables must be created before they can be used. This is done using the
Create Variable <AMVARIABLE> action. Once created, variables can be set using the Set Variable <AMSET> action, or by certain actions that support populating variables. To get data out of the variables, in any action parameter, simply surround the variable name with percentage % signs (e.g. %varname%). Remember not to use percentage signs when specifying the name of a variable to populate, percentage signs are only needed to get data out.

Standard Error Handling Options
This action also includes the standard "Error Causes" and "On Error" failure handling options/tabs

More on Error Handling Options

Variables and Expressions
All text fields allow the use of expressions by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, a popup expression builder is available in all these fields by pressing F2.
More on variables...

More on expressions...

More on the expression builder...

Example

<AMVARIABLE NAME="thecounter">0</AMVARIABLE>
<AMLOOP TOTALLOOPS="100">
<AMDECREMENTVARIABLE RESULTVARIABLE="thecounter" AMOUNT="1">
</AMLOOP>

.